home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / getfile1.arc / GETFILE.DOC < prev    next >
Text File  |  1991-04-19  |  4KB  |  93 lines
  1. GETFILE v1.1  (91 04 19)  Documentation
  2. -------------------------------------------------------------------------------
  3.  
  4. Ok, I've given in to peer pressure and written some documentation for this 
  5. thing.  GETFILE is a small door that uses the special features of PCBoard 14.5a 
  6. to include the file descriptions along with the rest of your batch download.  
  7. This is a feature I think, that all bbs and protocol developers should think 
  8. about incorporating.  
  9.  
  10.  
  11. THE PROBLEM:
  12.   You download quite regularly from bulletin boards, but when you finnally 
  13. take a look at your directory, you forget what the hell you downloaded!  
  14.  
  15.  
  16. THE SOLUTION:
  17.   You have two options:  Either spend 'x' amount of time downloading the
  18. entire file list from the bulletin board, or use GETFILE.
  19.  
  20.  
  21. WHAT GETFILE DOES:
  22.   GetFile loads up your pcboard.dat file and gets the location of your dir.lst 
  23. file. It then opens it up and finds out what your directory file are.  Now it 
  24. goes through them and copies the file descriptions for the files you have 
  25. specified. It saves these file descriptions to a plain text file.  It then save 
  26. the following to PCBSTUFF.KBD: "DB descfile.txt file1 file2 file3 ..." where
  27. descfile.txt is the name that you specified and file1, file2, file3... are the 
  28. names of the files you wish to download.  This has the effect of stuffing this 
  29. string into the keyboard as if you would have typed it. Ces't tous! (That's it)
  30.  
  31.  
  32. USAGE:
  33.   GETFILE <pcboard.dat> <descfile.txt> <file1> [file2 [file3...]]
  34.  
  35. eg.  GETFILE %PCBDAT% C:\PCB\BLT\FLDESC%NODE%.TXT %PCBDOOR%
  36.  
  37.  
  38. EXPLANATION OF USAGE:
  39.   The %PCBDAT% parameter is the environmental variable set by PCBoard that
  40. is the path and name of your current PCBOARD.DAT file.
  41.   The <descfile.txt> parameter has the %NODE% variable in it for multi-node
  42. system.  Since two users could be using GETFILE at the same time, this makes
  43. sure they are using different text files.  This file HAS to reside in one of 
  44. your download paths!  You can later delete these file description files in your
  45. event.
  46.   The %PCBDOOR% paramter is the variable set by PCBoard that has the parameters
  47. that were typed after the door name while the user was in PCBoard.  
  48.   Eg.  GETFILE PCBFILES PKUNZIP.EXE
  49.    PCBDOOR would be "PCBFILES PKUNZIP.EXE"
  50.  
  51.  NOTE:  PCBFILES would be looked up as PCBFILES.ZIP if ZIP was your default
  52.         extension as set by in PBCSETUP.  If you default extension was ARC,
  53.         then it would be PCBFILE.ARC instead.
  54.  
  55.  
  56. SYNTAX IN PCBOARD:
  57.   To make this door small, there is no code to ask the user for the file names.
  58. This would have made the door a lot bigger since I would have needed to 
  59. incorporate communications code to access the COM ports.  Instead I opted for
  60. a simpler method.  For GETFILE to operate properly the user must type in the
  61. filenames on the same line as GETFILE.  Just typing in GETFILE by itself will
  62. download an empty file description file.
  63.  
  64.  
  65. SETING UP:
  66.   I recommend shelling to GETFILE from PCBoard by using these parameters in 
  67. your door.lst file:
  68.  
  69.     File Name   Sec  Login   USER SYS   DOOR SYS    Shell
  70.     GETFILE     20   N       N          N           Y   
  71.  
  72.  
  73. DISCLAIMER:
  74.   Offiously, I will not be responsible for damages that you may inflict on
  75. any computer equipment (hardware or software) just because you used my
  76. software.  GETFILE is being distributed as freeware,  it is free to any one.
  77. Please don't sell it or include it in a package that will then be sold.  The
  78. source code is available to anyone who wants it by contacting me.
  79.  
  80.  
  81. AUTHOR:
  82.   I can be reached at Saltair, the PCBoard support BBS, as "CANADIAN INT.". 
  83.  
  84.   Roy Pereira (819) 994-3857
  85.   CIDA bbs    (819) 953-8208/8207  14400 Dual HST/Ultra 96 (DataPac soon)
  86.   Saltair bbs (801) 261-8976       9600 HST
  87.  
  88.  
  89. APPOLOGIES:
  90.   I do appologize to anyone who was frustrated by GETFILE without any
  91. documentation.  I hope this helps.  If this document isn't clear enough though,
  92. I will answer your questions at the above places.
  93.